home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / internet-tools / amitcp / amitcp-2.2 / doc / ls.doc < prev    next >
Encoding:
Text File  |  1993-10-13  |  4.8 KB  |  129 lines
  1. NAME
  2.      ls - list contents of directory
  3.  
  4. VERSION
  5.      $Id: ls.1,v 1.2 93/10/13 04:52:11 ppessi Exp $
  6.  
  7. SYNOPSIS
  8.      ls [ -acdfgilqrst1ACLFR ] name ...
  9.  
  10. DESCRIPTION
  11.      For each directory argument, ls lists the contents of the
  12.      directory; for each file argument, ls repeats its name and
  13.      any other information requested.  By default, the output is
  14.      sorted alphabetically.  When no argument is given, the
  15.      current directory is listed.  When several arguments are
  16.      given, the arguments are first sorted appropriately, but
  17.      file arguments are processed before directories and their
  18.      contents.
  19.  
  20.      There are a large number of options:
  21.  
  22.      -l   List in long format, giving mode, number of links, owner, size
  23.       in bytes, and time of last modification for each file.  (See
  24.       below.) If the file is a symbolic link the pathname of the
  25.       linked-to file is printed preceded by "->".
  26.  
  27.      -g   Include the group ownership of the file in a long output.
  28.  
  29.      -t   Sort by time modified (latest first) instead of by name.
  30.  
  31.      -a   List all entries; in the absence of this option, entries whose
  32.       names begin with a period (".") or end with ".info" are not
  33.       listed.
  34.  
  35.      -A   List all entries except entries whose names end with ".info".
  36.  
  37.      -s   Give size in blocks of each file.
  38.  
  39.      -d   If argument is a directory, list only its name; often used
  40.       with -l to get the status of a directory.
  41.  
  42.      -L   If argument is a symbolic link, list the file or directory the
  43.       link references rather than the link itself.
  44.  
  45.      -r   Reverse the order of sort to get reverse alphabetic or
  46.       oldest first as appropriate.
  47.  
  48.      -i   For each file, print the key block number in the first column
  49.       of the report.
  50.  
  51.      -f   Force each argument to be interpreted as a directory and list
  52.       the name found in each slot.  This option turns off -l, -t,
  53.       -s, and -r, and turns on -a; the order is the order in which
  54.       entries appear in the directory.
  55.  
  56.      -F   cause directories to be marked with a trailing `/', hard links
  57.       sockets with a trailing `#' and symbolic links with a trailing
  58.       `@'.
  59.  
  60.      -R   recursively list subdirectories encountered.
  61.  
  62.      -p   include relative pathname into the long listing.
  63.  
  64.      -1   force one entry per line output format; this is the default
  65.       when output is not interactive.
  66.  
  67.      -C   force multi-column output; this is the default when output is
  68.       interactive.
  69.  
  70.      -q   force printing of non-graphic characters in file names as the
  71.       character `?'; this is the default when output is interactive.
  72.  
  73.      The mode printed under the -l option contains 10 characters which
  74.      are interpreted as follows: the first character is
  75.  
  76.      d    if the entry is a directory;
  77.      r    if the entry is a root directory;
  78.      l    if the entry is a symbolic link;
  79.      D    if the entry is a hard link to a directory;
  80.      p    if the entry is a pipe file;
  81.      h    if the entry is a hard link to a file, or
  82.      -    if the entry is a plain file.
  83.  
  84.      The next 9 characters are interpreted as three sets of access
  85.      control bits. The first set refers to owner permissions; the next
  86.      refers to permissions to others in the same user-group; and the
  87.      last to all others. Within each set the three characters indicate
  88.      permission respectively to read, to write, or to execute the file
  89.      as a program. For a directory, `write' and `execute' permissions
  90.      are meaningless. The permissions are indicated as follows:
  91.  
  92.      r    if the file is readable;
  93.      w    if the file is writable;
  94.      x    if the file is executable;
  95.      -    if the indicated permission is not granted.
  96.  
  97.      The write-permission character is given as a D if the file is
  98.      deleteable but not writeable. It is given as a 'W' if the file is
  99.      writeable but not deleteable. The group-execute permission
  100.      character is given as s if the file has the set-group-id bit set;
  101.      likewise the user-execute permission character is given as s if the
  102.      file has the set-user-id bit set.
  103.  
  104.      The last character of the mode (normally `x' or `-') is 't' or 'T'
  105.      (as sticky in Unix systems) if the pure bit of the mode is on. If
  106.      the script bit is on, the last character is 's' or 'S'. The
  107.      protection bits `h' and `a' are not printed.
  108.  
  109.      When the sizes of the files in a directory are listed, a total
  110.      count of blocks (not including indirect blocks) is printed.
  111.  
  112. FILES
  113.      AmiTCP:db/passwd to get user id's for `ls -l'.
  114.      AmiTCP:db/group to get group id's for `ls -g'.
  115.  
  116. BUGS
  117.      The option setting based on whether the output is interactive is
  118.      undesirable as "ls -s" is much different than "ls -s > t:file".
  119.  
  120.      The printed protection flags are inadequate for AmigaDOS. The root
  121.      directory flags are garbage. There are problems when printing
  122.      soft links.
  123.  
  124.      There are too many options.
  125.  
  126. AUTHOR
  127.      Pekka Pessi, <Pekka.Pessi@hut.fi>. 
  128.      ls is part of the AmiTCP/IP package.
  129.